Add some hints about titles on about dialogs

svn path=/trunk/; revision=17545

diff --git a/ChangeLog b/ChangeLog
index 02e0bd76f167db0c2e0641148bd10b436bbc749a..6b673df04b3d9abf03bb54b3a48cabbb5ad8e07e 100644 (file)
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,8 @@
+2007-03-19  Matthias Clasen <mclasen@redhat.com> 
+
+       * demos/gtk-demo/appwindow.c: Explicitly set the title on the
+       about dialog.
+
 2007-03-18  Matthias Clasen <mclasen@redhat.com> 
 
        * gtk/gtkentrycompletion.c (gtk_entry_completion_compute_prefix):

diff --git a/demos/gtk-demo/appwindow.c b/demos/gtk-demo/appwindow.c
index 9fea12fa515cd812f89f0ead1cbcdc76c824d1c1..fd3e8fb7185cf13291e97a37bfee5fae95672a8e 100644 (file)
--- a/demos/gtk-demo/appwindow.c
+++ b/demos/gtk-demo/appwindow.c
@@ -141,6 +141,7 @@ about_cb (GtkAction *action,
                         "authors", authors,
                         "documenters", documentors,
                         "logo", transparent,
+                         "title", "About GTK+ Code Demos",
                         NULL);
 
   g_object_unref (transparent);

diff --git a/docs/reference/ChangeLog b/docs/reference/ChangeLog
index 371225506034e399b61d1b21e9970796c36d440e..6644b7bfe85cf3d0d1206093b24ab51e22610ac1 100644 (file)
--- a/docs/reference/ChangeLog
+++ b/docs/reference/ChangeLog
@@ -1,3 +1,8 @@
+2007-03-19  Matthias Clasen  <mclasen@redhat.com>
+
+       * tmpl/gtkaboutdialog.sgml: Add a paragraph about setting
+       the title on the dialog.
+
 2007-02-14  Stefan Kost  <ensonic@users.sf.net>
 
        reviewed by: Matthias Clasen  <mclasen@redhat.com>

diff --git a/docs/reference/gtk/tmpl/gtkaboutdialog.sgml b/docs/reference/gtk/tmpl/gtkaboutdialog.sgml
index 558dd856fd077601ba64708c6f63f2242fe88b3b..ad9d4ae5c38b07984986aea2b7d7d95d7047e90d 100644 (file)
--- a/docs/reference/gtk/tmpl/gtkaboutdialog.sgml
+++ b/docs/reference/gtk/tmpl/gtkaboutdialog.sgml
@@ -28,6 +28,20 @@ To make constructing a #GtkAboutDialog as convenient as possible, you can
 use the function gtk_show_about_dialog() which constructs and shows a dialog 
 and keeps it around so that it can be shown again.
 </para>
+<para>
+Note that GTK+ sets a default title of <literal>_("About &percnt;s")</literal> 
+on the dialog window (where &percnt;s is replaced by the name of the 
+application, but in order to ensure proper translation of the title, 
+applications should set the title property explicitly when constructing 
+a #GtkAboutDialog, as shown in the following example:
+</para>
+<informalexample><programlisting>
+gtk_show_about_dialog (NULL, 
+                       "name", "ExampleCode",
+                       "logo", example_logo,
+                       "title" _("About ExampleCode"),
+                       NULL);
+</programlisting></informalexample>
 
 <!-- ##### SECTION See_Also ##### -->
 <para>